Color Computer 2 
MICRO¬ 
COMPUTER 



Start-Up 


1. Turn the television set ON. 

2. Select channel 3 or 4. 

3. Set the Antenna Switch to “COMPUTER.” 

4. Turn on any accessory equipment (e.g., a printer). 

5. If you’re using a Program Pak™, insert it now, before turning on 
the Computer. 

6. Turn the Computer ON. 

7. If you’re not using a Program Pak™, the Color BASIC or 
Extended Color BASIC start-up message will appear on the TV, 
followed by: OK 

The Computer is now ready to use. 

tote: information pertaining to Extended Color BASIC only is 
shaded like this paragraph. Non-shaded Information pertains to 
both Extended and non-Extended Color BASIC, 










Color Computer 2 
MICRO¬ 
COMPUTER 





Start-Up 


1. Turn the television set ON. 

2. Select channel 3 or 4. 

3. Set the Antenna Switch to “COMPUTER.” 

4. Turn on any accessory equipment (e.g., a printer). 

5. If you’re using a Program Pak™, insert it now, before turning on 
the Computer. 

6. Turn the Computer ON. 

7. If you’re not using a Program Pak™, the Color BASIC or 
Extended Color BASIC start-up message will appear on the TV, 
followed by: DK 

The Computer is now ready to use. 

Note; information pertaining to Extended Color BASIC only is 
shaded like this paragraph. Non-shaded information pertains to 
both Extended and non-Extended Color BASIC. 


Video Control Codes 


Dec Hex PRINT CHR$ (code) 

8 08 Backspaces and erases current character. 

13 0D Line feed with carriage return. 

32 20 Space 


Operators 


Each operator or group of operators is 
precedent over the group below it. 


Exponentiation 

Unary negative, positive 

Multiplication, division 

Addition and concatenation, subtraction 


<,>, = ,< = ,> = ,<> Relational tests 

NOT 

AND 

OR 


Graphic Character Codes 

Given the color (1-8) and the pattern (0-15), this formula will 
generate the correct code: 

code = 128 -k 16 * (color- 1) + pattern 


■ I <1 


12 


■ I *H YIL 
E ,3 1 "B ,s l 


For example, to print pattern 9 in blue (code 3), type: 

C = 128 + 18 * (3-1 ) + 9 
? CHR$ (C) 


Functions 


Argument ranges are indicated by special symbols: 

numeric: (-10 38 , + 10 38 ) 
x : (0-255) 

y: (0-191) 

location : (0-65535) 
code : (0-255) 

str. string argument 

van variable name 


Computes absolute value. 


ABS (numeric) 

Y = A B S ( 5 ) 

ASC (str) Returns ASCII code of first character of specified 
string. 

A = ASC(T$) 


Returns arctangent in radians. 


ATN (numeric) 

Y = A T N ( X / 3 ) 

CHR$ (code) Returns character for ASCII, control, orgraphics 
code. 

? CHR$(191) 

P$=CHR$(T) 

COS (numeric) Returns cosine of an angle given in radians, 

Y = COS (7 > 

EOF (f) Returns FALSE (0) if there is more data; TRUE(-I) if 
end of file has been read. For cassette, f = - 1; for keyboard, 
f= 0. 

EOF =(- 1 ) 

EOF ( 0 ) _ _ ._._._._.____ 

EXP (numeric) 

^numberx 

Y=EXP { 7 ) 


Returns natural exponential of number 


FIX (numeric) Returns truncated (whole number) value. 

Y = F 1X17*6} 

HEX$ (numeric) Computes hexadecimal value 

MMjjjl11 ■ . yy m . m | | I ■ y. | ... 

INKEY$ Checks the keyboard and returns the key being 
pressed (if any). 

A$=INKEY$ 


INT (numeric) 

X=INT(5.2) 


Converts a number to an integer. 
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JOYSTK (j) Returns the horizontal or vertical coordinate (/) of 

the left or right joystick: 

0 = horizontal, left joystick 

1 = vertical, left joystick 

2 = horizontal, right joystick 

3 = vertical, right joystick 
M=JOYSTK(0) 

H=JOYSTK(K> 


LEFT$ (strjength) 

string. 

P$ = LEFT$(M$ * 7 ) 

LEN (str) Returns the length of a string. 

X=LEN(SEN$) 


Returns left portion (length characters) of 


Returns natural logarithm. 


LOG (numeric) 

Y = LOG (353 5- 

MEM Finds the amount of free memory. 

PRINT MEM 

MID$ ( str, pos,length ) Returns a substring of another string 

starting at pos. If length is omitted, the entire string right of 
position is returned. 

F$ = MID$(A$*3) 

? MID$(A$ 1 3 12 ) 

PEEK (location) Returns the contents of specified memory 

location, 

A=PEEK(3207G) 

POINT (x,y) Tests whether specified graphics cell is on or off, x 

(horizontal) =0-63;/(vertical) = 0-31. The value returned is-1 if 
the cell is in a text character; mode; 0 if it is off, or the color code if 
it is on. See CLS for color codes. 

IF POINT (10*10) THEN PRINT "ON" ELSE PRINT 
"OFF" 

POS (device) Returns current print position. Device -1 = 

printer,-2 = display. 

PRINT TAB'S) POSC#) 

PPOINT (x,y) Tests whether specified graphics cell is on or off 

and returns color code of specified cell. 

PPOINT ( 13 #35 3 

RIGHTS (strjength) Returns right portion of string. 

ZIP$ = RIGHT$(AD $* 5 ) 

SGN (numeric) Returns sign of specified numeric expression: 
-1 if argument is negative 

0 if argument is 0 

+ 1 if argument is positive 

X = S G N < A * B ) 

SIN (numeric) Returns sine of angle given in radians. 

Y = S I N ( 5 ) 


STRINGS (length,code or string) Returns a string of 

characters (of specified length) specified by ASCI! code or by the 
first character of the siring. 

?STRING*<5f" 1 ") 

?STRING*(5*91) 


STR$ (numeric) 

S * = S T R * ( X ) 

SQR (numeric) 

Y=SQR(5+3) 

TAN (numeric) 

Y = TAN ((15.7) 

TIMER Returns contents or allows setting of timer (0-65535). 

? ill!! 

. TIMER=0 ■ ■ , 

USRft (numeric) 

X = USR(Y) 

VAL (str) Converts a string to a number. 

A = U A L ( B * ) 

VARPTR (var) Returns address of pointer to the specified 

variable. 

Y=USR<VARPTR(X) ) 


Converts a numeric expression to a string. 

Returns the square root of a number 
Returns tangent of angle given in radians. 


Calls user's machine-language subroutine. 


Control Keys 


@ 


(SHIFT) @ 
(BREAK) 

(CLEAR) 


(ENTER) 


(SPACEBAR) 

(SHIFT) © 
(SHIFT) QD 


Cancels last character 

typed; moves cursor back one space. 

Erases current line. 

Interrupts anything in progress and 
returns to command level. 

Clears the screen. 

Signifies end of current line. 

Enters a space (blank) character and 
moves cursor one space forward. 

Causes currently executing program to 
pause (press any key to continue). 

All-caps/upper-lowercase 
keyboard switch. (Lowercase 
displayed as reversed capitals.) 


Special Characters 

Abbreviation for REM. 

$ Makes variable string type. 

: Separates statements on the same line. 

? Same as PRINT. 

, PRINT punctuation: spaces over 

to the next 16-column PRINT zone. 

; PRINT punctuation: separates items in a 
print list but does not add spaces 
when they are output. 


Error Messages 


Abbreviation 

Explanation 

/ 0 

Division by 0 

AD 

File already OPEN 

BS 

Subscript out of range 

CN 

Can’t continue 

DD 

Redimensioned array 

DN 

Device number error 

DS 

Direct statement in file 

FC 

Illegal function call 

FD 

Bad file data 

FM 

Bad file mode 

ID 

Illegal direct 

IE 

Input past end of file 

I/O 

Input/Output error 

LS 

String too long 

NF 

NEXT without FOR 

NO 

File not open 

□ D 

Out of data 

□ M 

Out of memory 

OS 

Out of string space 

0M 

Overflow 

RG 

RETURN Without GOSUB 

SN 

Syntax error 

ST 

String formula too complex 

TM 

Type mismatch 

UL 

Undefined line 


C and EXTENDED CO 
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Statements 

AUDIO Connects or disconnects cassette output to TV 
speaker. 

AUDIO ON 
AUDI 0 OFF 

CIRCLE (x,y),r,c,hw,start.end Draws a circle with center at 
point (x.y) radius r, specified color c. height width ratio (hw) of 
0-4. Circle can start and end at specified point (0-1). 

CIRCLE ( 128 »90) ,50 ,4 #1 ♦ ♦5 , ♦75 

CLEAR n,h Reserves n bytes of string storage space. Erases 

variables, h specifies highest BASIC address. 

CLEAR 

CLEAR 500 

CLEAR 100 * 14000 

CLOAD Loads specified program file from cassette. If file name 
is not specified, first file encountered is loaded. File name must 
be eight character/spaces or fewer. 

CLOAD 

CLOAD "PROGRAM" 

CLOADM Loads machine-language program from cassette 
An offset address to add the loading address may be specified. 
CLOADM "PROG" 

CLOADM 

CLOADM "PROG" # 1000 

CLOSE d Closes open files. 

CLOSE 

CLOSE-2 

CLS c Clears display to specified color c. If color is not 

specified, green is used. 

0-Black 

1- Green 5-Buff 

2- Yellow 6-Cyan 

3- Blue 7-Magenta 

4- Red 8-Orange 

CLS 
CLS 3 

COLOR (foreground, background) Sets foreground 
and background color. 

COLOR! »3 

CONT Continues program execution after pressing (BREAK) or 

using STOP statement. 

CONT 

CSAVE Saves program on cassette (program name must be 
eight character/spaces or less). If A is specified, program saved 
is ASCII format. 

CSAVE "PROGRAM" 

CSAVE "PROGRAM" »A 


CSAVEM name, start, end, transfer Writes out a 

machine-language file. 

CSAVEM "X" »4E*6F *5F 

DATA Stores data in your program. Use READ to assign this 
data to variables. 

DAT A 5»3 * PEARS 
DATA PAPER # PEN 

DEF FN Defines numeric function 
DEF FN ( X ) = X * 3 

DEFUSR o Defines entry point for USR function n.n- 0-9. 
DEFUSR5=45643 

DEL Deletes program lines. 

•' HISS® : '- 

DEL.25 

'D£L;25~ 

DEL-2.5- 
DEL 10-25 

DIM Dimensions one or more arrays. 

DIMR(G5) #W(40) 

DIMAR$(8#25) 

DLOAD Loads BASIC program at specified baud 

■ ■■ jj | jj I 

0 - 300 baud 1 = 1200 baud 
DL GA0 5X " # 1 

DRAW Draws a line beginning at specified starting point of 
specified length of specified color. Will also draw to scale, draw 
blank lines, draw non-updated lines, and execute substrings. II 
starting point is not specified, last DRAW position or (128.96) is 

DRAW ' BM100 # ■■ 00 5 S 1 0 5 U25 5 BR25 5ND25 ?XA$ ? " 

EDIT Allows editing of program line. 
nC Changes n number of characters. 
nD Deletes n number of characters. 

I Allows insertion of new characters. 

H Deletes rest of line and allows insert. 

L Lists current line and continues edit. 

nSc Searches for nth-occurrence of character c. 

(SHIFT) ($1 Escape from subcommand. 
n (SPACEBAR) Moves cursor n spaces to right, 
n @ Moves cursor n spaces to left. 
f_d i t 25 inter: 

END Ends program. 

END 

EXEC (address) Transfers control to machine-language 

programs at specified address. If address is omitted, control is 
transferred to address set in last CLOADM. 

EXEC 

EXEC 32453 


FOR..TO Creates a loop in program which the Computer must 

STEP/ repeat from the first number to the last number you specify. 
NEXT Use STEP to specify how much to increment the number 
each time through the loop. If you omit STEP, one is used. 

F0RX = 2T05 sNEXTX 

FOR A= 1 TO 10 STEP 5 :NEXT A 

FOP M 30 TO 10 STEP -5 : NEXT M 

GET (start)-(end), destination, G Reads the graphic 
contents of a rectangle into an array for future use by PUT 
GET (5 120)-(3 ,8 ) * V»G 

GOSUB Calls a subroutine beginning at specified line number. 
G0SUB 500 

GOTO Jumps to specified line number. 

GOTO 300 

IFTESTTHEN. . .ELSE action 1, action 2 Performs a test. 

IF it is true, the Computer executes action 1. If false, action 2 is 
executed. 

IF A = 5 THEN 30 

INPUT Causes the Computer to stop and await input from the 

keyboard. 

INPUT X$ 

INPUT "NAME" 5 N$ 

INPUT#-! Inputs data from cassette. 

INPUT#-1 t A 

INSTR ( position, search, target) Searches for the first 

occurrence of target string in search string beginning at position. 
Returns the position at which the match is found. 

? INSTR (5 t X$ t V $) 

LET Assigns value to variable (optional). 

LET m = | J.0-B A H 

LIST Lists specified line(s) or entire program on screen. 

LIST 

LIST 50-85 
LIST 30 
LIST-30 
LIST 30- 

LLIST List specified program line(s) or entire program to printer. 
LLIST 

LLIST 50-85 
LLIST 30 
LLIST-30 
LLIST 30- 

LINE (xl,yl)-(x2,y2), PSET or PRESET, BI Draw a line 
from (x1,y1) to (x2.y2). if (x1,y1) is omitted, the last end pointer 
(128.96) is used. PSET selects foreground color and PRESET 
selects background color. ,B draws a box with {xl.yl ) and 
( x2.y2) as the opposing corners. .BF will fill in the box with 
foreground color. 

LINE(5,3)-(G * G) »PSET 































and EXTENDED COLOR BASIC 


JSt 

;ify. 

>r 


est. 

IS 


ion. 


iter. 


LINE INPUT Input line from keyboard 
LINE INPUT ANSWER" 5X$ 

MID$ (oldstr, position, length) Replaces a portion of one 

string with another string. 

M10$ < A$ >14 :>2) -- ,f KS" 

MOTOR Turns cassette ON or OFF. 

MOTOR ON 
MOTOR OFF 

NEW Erases everything in memory. 

NEW 

ON. . .GOSUB Multi-way branch to call specified subroutines. 

ONYGOSUB50 >100 

ON. . .GOTO Multi-way branch to specified lines. 

ON X GOTO 190 >200 

OPEN m,#d,f Opens file (f) at: Screen or Keyboard (0); 
Cassette (-1); Printer (-2). For input (I), or output (O). 

OPEN"0">-l > "DATA" 

PAINT (x,y),c,b Paints graphic screen starting at point (x,y) 

with specified color c and stopping at border (b) of specified 

'v,;;.;//. I ; 1 j||| MNjf 

PCLEAR a Reserves n number of 1.5 K graphics memory 

■■/'LL.:' ■■■.Tv I J § | L-j . | MjllMj j 

MIBBMB j jjl 

PCLS c Clears screen with specified color c . If color code is 

omitted, current background color is used. (See CLS for color 

| : Ijj J| j§■■■ | ■ |H M ' 11111 | |t 

PCLS 3 

PCOPY Copy graphics from source page to destination page. 

POOPY 5 TO 6 

PLAY Piays music of specified note (A-G or 1 -12). octave (O), 
volume (V), note-length (L), tempo (T), pause (P), and allows 
execution of substrings. Also sharps (# or -) and flats {-). 

PLAY "LI 5A# 5P8 5V10 5T3 5L2 5B-5 95XA$5" 


PMODE mode, start-page 

memory page. 

PMODE A >1 

POKE (location, value) 

memory location. 

POKE 15872 >255 


Selects resolution and first 


Puts value (0-255) into specified 


PRESET Reset a point to background color. 

PRESET(5tG) 

PRINT Prints specified message or number on TV screen. 
PRINT "HI" 


PRINT#-1 Writes data to cassette. 

PRINT A$ 

? A$ 

PRINT#-1 >A 

PRINT#-2 Prints an item or list of items on the printer. 

PR INT#-2>CAP* 

PRINT TAB Moves the cursor to specified column position. 
PRINTTAB<5>"NAME" 

PRINT USING Prints numbers in specified format 
# Formats numbers. 

PRINT USING 5 G2 ♦ 2 

j '■■■'. ' I 

PRINT USING "##-#" 558 ♦B 

> Displays comma to left of every third character. 

PRINT USING "####>" 5 44,0 
+ + Fills leading spaces with asterisks 

PR I NT USING "**##*##" 5 33*3 
$ Places $ ahead of number. 

PR I NT USING "$##*##" 5 33 *3 

PR I NT US I NG " $$## * -4 "511* 544 

PR I NT US I NG " **$# " 5 8 ■ 333 

In first position, causes sign to be printed. In last 

position, causes sign to be printed after the number 
PRINT USING "+#*T*#" 5-21G 
■ - ' ' ' :x '')t sntii form at. ■■■ LT':. 

PR I NT USING "##># tut" 5 5 4 G 
Minus sign after negative numbers. 

PR I NT USING"#*,#-" 5 -534*7 
/ Returns first string character. 

PRINT USING " ! " 5 "YELLOW" 

V<>spaces% String field; length of field is number of spaces 

I ' . j|J |H ' ' Jjjjj m ■■■ ■ f >.: ■ ■ 

PRINT USING "Z 1" 5 "BLUE" 

PRINT @ location Prints specified message at specified text 
screen location. 

PR I NT @ 25S > " H I " 

PRINT @ 25G > A$ 


PSET (x,y,c) Sets a specified point {x,y) to specified color c. If c 
is omitted, foreground is used. 

PSET(5 > S > 3 > 

PUT (start)-(end), source, action Stores graphics from 
source onto start/end rectangle on the screen. (Array rectangle 
size must match GET rectangle size.) 

PUT<3>2)-<5>6) >U>PSET 


READ Reads the next item in DATA line and assigns it to 
specified variable. 

READ A$ 

READ C >B 


REM Allows insertion of comment in program line. Everything 
after REM is ignored by Computer. 

REMTHIS IS IGNORED 
10?X$ :REM IGNORE 

RENUM newline « startline, increment Allows program line 

renumbering. 


RESET (x,y) Resets a point. 

RESET (14 >15) 

RESTORE Sets the Computer’s pointer back to first item on the 

first DATA line. 

RESTORE 

RETURN Returns the Computer from subroutine to the BASIC 

word following GOSUB. 

RETURN 

RUN Executes a proqram. 

RUN 

SCREEN screen-type, color-set Selects either graphics (1) 

or text (0) screen and color-set (0 or 1), 

SET ( x,y,c ) Sets a dot at specified text screen location to 

specified color. 

SET(14 >13 >3) 

SKIPF Skips to next program on cassette tape, or to end of 
specified program. 

SKIPF"PROGRAM" 

SOUND tone, duration Sounds specified tone for specified 
duration. 

SOUND 128 >3 

STOP Stops execution of a program. 

STOP 

TROFF Turns off program tracer. 

TRON Turns on program tracer. 

IRON 





















